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CATEGORY INDEX 



Executive Routines, Assemblers , and Compilers 

PDP-1 -4 MAC — A Master Subroutine Control (DEC-2) 

PDP-1-5 MACRO (MIT-3) 

PDP-1 -2 7 Two-Core Version of DECAL F17d Binary 

PDP-1 -30 DX-1 Library Tapemaker 

PDP-1-39 DECAL-BBN, September 28, 1963 version 

PDP-1 -40 Linking Loader BBN 

PDP-1 -41 Libtapemaker BBN 

PDP-1-46 DECAL, F17c, Fl7d 

PDP-1-5 3 DX-1 Monitoring System 

PDP-1-71 FRAP (BBN-1) 

PDP-1-80 DEXTER, A Magnetic Tape Executive Routine 

PDP-1-82.3 FORTRAN for the PDP-1 

PDP-1-85 LISP for the PDP-1 

PDP-5-13 Assembler (for IBM 7094) 

PDP-5/8-20 Remote Operated FORTRAN System 

PDP-5/8-28 PAL III Modifications 

PDP-7-2 FAST (Fast Acquisition of System Tapes) 



II. Editors 



PDP-1-7 Expensive Typewriter (MIT-2) and modified version 

PDP-1 -2 9 TED: A Tape Editor 

PDP-1 -55 Scopeditor 

PDP-1 -69 SATED: Scope Aided Tape Editor 

PDP-1 -70 Frap Corrector (ADA-2) 

PDP-5-24 Vector Input/Edit 

PDP-7-9 Scope Text Editor for the PDP-7/340 



III. Debuggers 



PDP-1-6 DDT (MIT-1) 

PDP-1-28 Scopetrace 

PDP-1 -43 ITEK Compare Program 

PDP-1 -54 ADT, Debugging System for ASYS 

PDP-1-70 AID. Adams Associates Intercom and Debug Program 

(ADA-1) 

PDP-1-71 Typewriter Control (BBN-2) 



PDP-1-71 Collossal Typewriter (BBN-6) 

PDP-1-71 Trace (BBN-21) 

PDP-1-71 Debug (BBN-67) 

PDP-4-1 Automonitor Program 

PDP-4-5 KUS - Kie Utility System 

PDP-4-6 DDT-4 With Floating Point Input/Output and Drum 

Read-Write 
PDP-5-1 

and Service and Debugging Subroutines for the PDP-5 
PDP-5-2 

PDP-5-1. 1 BPAK - A Binary Input/Output Package 

PDP-5-2. 1 OPAK - An On -Line Debugging Program 

PDP-5 -11 PDP-5 Debug System 

PDP-5 -19 DDT-5-2 Octal Symbolic Debugging Program 

PDP-5/8-33 Tape to Memory Comparator 

PDP-5-36 Octal Memory Dump Revised 

PDP-7-3 CUS - Console Utility System 



IV. Punch and Loaders 

PDP-1-70 Prim. Punchout read-In Mode Tape (ADA-3) 

PDP-1-72 Binary Punchoff (BBN-3) 

PDP-1-72 Binary Punch and Load Package (BBN-46) 

PDP-1-79 Extended Memory Punch and Loader Routines 

PDP-4-8 Short Loader for the PDP-4 

PDP-5 -3 A Binary Relocatable Loader with Transfer Vector 

for the PDP-5 Computer 

PDP-5-12 Pack-Punch Processor and Reader for the PDP-5 

PDP-5-26 Compressed Binary Loader (C3L) Package 



PDP-5/8-27 ERC Boot 



V. Duplicator, Verifiers 

PDP-1-44 ITEK Tape Duplicating and Verifying Program 

PDP-1-71 Master Duplicator (BBN-27) 

PDP-1-74 Tapelibrary Program 

PDP-5/8-16 Tape Duplicator for the PDP-5/8 

PDP-5/8-22 DECtape Duplicate 

PDP-5/8-33 Tape to Memory Comparator 



VI . Arithmetic Routines - Elementary Functions, Numerical 
Input/Output 

PDP-1-8 Multiply Subroutine (BBN-10.) 

PDP-1-9 Divide (FXD-18) (BBN-47) 

PDP-1-10 Single Precision Floating Point (BBN-121) 

PDP-1-14 Decimal Input-Output Package (BBN-1010) 

PDP-1-15 FLINT-36 

PDP-1-19 Floating Reciprocal (OAL-LP-41) 

PDP-1-26 Floating Nth Integer Power (OAL-LP-43) 

PDP-1-37 DBN, DBI, DBF (GEO 243) 

PDP-1-38 BDN, BDI, BDF (GEO 244) 

PDP-1-47 Modifications to 18-18 Floating Point Arithmetic 

Package 
PDP-1-48 Double Precision Floating Point Mathematical Routines 
PDP-1-49 Double Precision Fixed Point Routines 
PDP-1-51 DSL Matrix Routines 
PDP-1-52 Matrix Operations Program for the Experimental 

Dynamic Processor 
PDP-1-5 7 Input-Output Routines 
PDP-1-63 Floating Point Interpreter (BBN-121a) 
PDP-1-67 "SIN_COS": Floating-Point Sine-Cosine Routines 
PDP-1-68 "SQRT" : Floating-Point Square Root Routine 
PDP-1-71 Binary to Decimal Printout and Punchout (BBN-13) 
PDP-1-71 Compare (BBN-54) 
PDP-1-73 MADCAP and MADCAP Checkup 

PDP-1-76 A 28 BIT Floating Point Package for the PDP-1 
PDP-1-86 Precision Hypotenuse/Square Root Subroutine 
PDP-4-2 Teletype Input and Output Package 
PDP-4-4 Read a Decimal Number from Keyboard 
PDP-4-9 SQRT - Single Precision Square Root Subroutine 
PDP-4-12 BOOLEPAC Subroutines 

PDP-5-4 Octal Typeout of Memory Area with Format Option 
PDP-5-6 BDC to Binary Conversion of 3-Digit Numbers 
PDP-5/8-7 Decimal to Binary Conversion By Radix Deflation 

on PDP-8 
PDP-5-8 PDP-5 Floating Point Routines 
PDP-5/8-21 Triple Precision Arithmetic Package 
PDP-5/8-29 BCD to Binary Conversion Subroutine (73.6 ijsec) 
PDP-5/8-35 Binary Coded Decimal to Binary Coversion 

Subroutine and Binary to Binary Coded Decimal 

Subroutine (Double Precision) 
PDP-5/8-38 FTYPE - Fractional Signed Decimal Type-In 
PDP-5/8-39 DSDPRINT, DDTYPE - Double-Precision Signed 

Decimal Input -Output Package 



PDP-7-1 Accelerated Radix Deflation and Superdecimal Data 

Bytes on the PDP-7 
PDP-7-10 DECPUN - Decimal Integer Punch Routine 
PDP-7-11 POSPNT - Positive Decimal Integer Print Routine 
PDP-7 -12 Punch Output Package 



VII. Special Functions 
(No entries) 



VIII. Displays 



PDP-1-1 Character -Display 

PDP-1-2 Type, Punch, Display Decimal (BBN-50) 

PDP-1-3 Display Line (BBN-34) 

PDP-1-50 BANNER (Minn -Hon) 

PDP-1-65 Digital Function Generate and Display (UAC-14) 

PDP-1-71 Pen-Tracker (BBN-33) 

PDP-1-71 Grid Plotting (BBN-45) 

PDP-1-75 SEETAPE - A Magnetic Tape Dump Program 

PDP-5/8-23 PDP-5/8 Oscilloscope Symbol Generator 

PDP-7-4 PTSCOP, PTPEN, PTPLOT, CALIBR, LISTEN 

PDP-7-8 FPTSCOP, FPTPFN, FPTPLOT, CALIBR, LISTEN 

PDP-7 -13 Preliminary Programming Manual for the 340 Display 



IX. Test Manipulation, Symbol Manipulation and Sorts 

PDP-1-21 Clear a Block (OAL-LP-7) 

PDP-1-24 Move a Program (OAL-LP-45) 

PDP-1-61 TLU - Table Lock-up 

PDP-1-62 DSL Block Manipulation Routines 

PDP-1-71 Tem-Stor Push Down (BBN-32) 

PDP-1-77 DSL SORT Routines - SORT 2, SORT 3 



X. Probability and Statistics - Curve Fittings 

PDP-1-17 Get Number of Permutations (OAL-LP-9) 

PDP-1-18 Random Walk Number (OAL-LP-42) 

PDP-1-25 Get Number of Combinations (OAL-LP-10) 

PDP-1-32 Gaussian Random Number Generator (BBN-15) 



PDP-1-34 Past Bivariate Generator (UAC-10) 

PDP-1-42 PDP-1 Two Memory Checkerboard Program 

PDP-1 -64 Random, Randmodn, Coin (BBN-23) 

PDP-4-3 Random Number Subroutine 

PDP-4-7 Bivariate Curve Fit (FOX PR-3) 

PDP-5/8-9 Analysis of Variance PDP-5/8 

PDP-5 -25 A Psuedo Random Number Generator 



XI. Scientific and Engineering Applications 

PDP-7-5 Kinematics - FORTRAN Subroutines 
PDP-7-6 CGC Function FORTRAN Subroutines 
PDP-7-7 Input ND180, Inflt ND180, Input Vectoreen, and 
Inflt Vectoreen 



XII. Hardware Control 

PDP-1-33 Scatter Gather MAG Tape Routine (BBN-lOllc) 

PDP-1-66 MRR - Short, Read Magnetic Tape Routines 

PDP-1 -78 Tape 52 Magnetic Tape Control Subroutines 

PDP-1 -81 Calcomp Plotter Software 

PDP-1-87 Buffered DECtape Read and Write Routines 

PDP-5/8-17 Drum Transfer Routine For Use on PDP-5/8 

PDP-5-30 GENPLOT - General Plotting Subroutines 

PDP-5-31 FORPLOT - FORTRAN Plotting Program for PDP-5 

PDP-5-37 Transfer II 

PDP-5 -40 ICS DECtape Routines (One-Page) 

PDP-7-12 Punch Output Package 



XIII. Games and Demonstrators 

PDP-1-50 Banner 

PDP-1-56 The Kalah Game Program 

PDP-1-71 Pen Tracker (BBN-33) 

PDP-1-71 Grid Plotting (BBN-45) 

PDP-5 -14 Dice Game for the PDP-5 

PDP-5 -15 ATEPO (Auto Test in Elementary Programming and 
Operation of a PDP-5 Computer) 



XIV. Linear Programming , Operations Research, Business Applications 

PDP-1-14 CPA-21 - Critical Path Analysis (BKS-1) 

PDP-1-71 Tem-Stor Push Down (BBN-32) 

PDP-4-11 Engineering Project Scheduling System 



XV. Desk Calculators 



PDP-1-31 Expensive Desk Calculator (Binary) 
PDP-5-5 Expanded Adding Machine 



XVI. Maintenance 



PDP-1-45 BKS Start-Stop Reader Test 
PDP-1-71 Rotate Test (BBN-25) 
PDP-5-10 Paper Tape Reader Tester 



XVII. Miscellaneous 



PDP-1-11 Tone Generation Routine (BBN-5) 

PDP-1-12 Bit Manipulation Package (BBN-11) 

PDP-1-16 Check Parity (OAL-LP-44) 

PDP-1-20 Millisecond Clock (OAL-LP-18) 

PDP-1-22 Second Delay (OAL-LP-12) 

PDP-1-23 Millisecond Delay (OAL-LP-11) 

PDP-1-35 RATBIN (GEO 215) 

PDP-1-36 CHKSYM (GEO 217) 

PDP-1-58 UNARY Manipulation Routines 

PDP-1-59 Title 

PDP-1-60 SFLAG, RFLAG 

PDP-4-10 Multi-Clock Simulation Subroutine 

PDP-4-13 FISP: Foxboro Interpretive Simulation Program 

PDP-5-18 Binary Tape Disassembler 

PDP-5/8-32 Program to Relocate and Pack Programs in Binary 

Format 
PDP-5-34 Memory Halt - A PDP-5 Program to Store Halt in 

Most of Memory 



PDP-1 INDEX 

DECUS No . Title Page No 

1 BBN-37A Character-Display 7 

2 BBN-50 Type, Punch and Display Decimal Program 7 

3 BBN-34 Display Line 7 

4 DEC-2 MAC-A Master Subroutine Control System 7 

5 MIT-3 MACRO 7 

6 MIT-1 DDT 8 

7 MIT-2 Expensive Typewriter 8 
7A Modified Expensive Typewriter (Macro) 27 

8 BBN-10 Multiply Subroutine 8 

9 BBN-47 Divide (FXD-18) 8 

10 BBN-121 Single Precision Floating Point 8 
Routines 

11 BBN-5 Tone Generation Routine 8 

12 BBN-11 Bit Manipulation Package 9 

13 BKS-1 CPA-21 - Critical Path Analysis 9 

14 BBN-1010 Decimal Input-Output Package 9 

15 FLINT-36 ITEK 9 

16 OAL-LP-44 Check Parity 10 

17 OAL-LP-9 Get Number of Permutations 10 

18 OAL-LP-42 Random Walk Number 10 

19 OAL-LP-41 Floating Reciprocal 10 



DECUS No. Title Page No, 

20 OAL-LP-18 Millisecond Clock 10 

21 OAL-LP-7 Clear A Block 10 

22 OAL-LP-12 Second Delay 10 

23 OAL-LP-11 Millisecond Delay 11 

24 OAL-LP-45 Move A Program 11 

25 OAL-LP-10 Get Number of Combinations 11 

26 OAL-LP-43 Floating Nth Integer Power 11 

27 Two-core version of DECAL F17d Binary, RIM 11 

(BBN) 

28 SCOPETRACE (DSL) 11 

29 TED: A Tape Editor (DSL) 12 

30 DX-1 Library Tapemaker (AFCRL) 12 

31 Expensive Desk Calculator (Read-in-mode 12 
only) (M.I.T.) 

32 BBN-15 Gaussian Random Number Generator 12 

33 BBN 1011c Scatter Gather Mag Tape Routine 12 

34 UAC-10 Fast Bivariate Generator 13 

35 GEO 215 RATBIN (read and type a binary paper 13 
tape) 

36 GEO 217, CHKSYM (check a symbolic tape) 13 

37 GEO 243, dbn (decimal to binary mixed number) , 13 

dbi (decimal to binary integer) and 
dbf (decimal to binary fraction) (FRAP) 



DECUS No . Title Page No . 

38 GEO 244 , bdn (binary to decimal mixed number) , 13 

bdi (binary to decimal integer) , and 
bdf (binary to decimal fraction) (FRAP) 

39 DECAL-BBN, September 28, 1963 Version 13 

40 Linking loader BBN 14 

41 Libtapemaker BBN 14 

42 PDP-1 Two Memory Checkerboard Program 14 

43 ITEK Compare Program 14 

44 ITEK Tape Duplicating and Verifying Program 14 

45 BKS Start-Stop Reader Test 14 

46 DECAL, Fl7c, Fl7d (single core-binary only) 15 

(BBN) 

47 Modifications to 18-18 Floating Point 15 
Arithmetic Package (To be distributed with 
DECUS No. 10) 

48 Double Precision Floating Point Mathematical 15 
Routines (DX-1 AFCRL) 

49 Double Precision Fixed Point Routines 15 

(Minn-Hon) 

50 BANNER (Minn-Hon) 16 

51 DSL Matrix Routines 16 

52 Matrix Operations Procram for the Experimental 16 
Dynamic Processor 

5 3 DX-1 Monitoring System (Write-up only) 16 

54 ADT, Debugging System for ASYS (Write-up only) 17 



DECUS No . Title Pace No , 

55 Scopeditor (BBN) 17 

56 The KALAK Game Program 17 

57 Input -Output Routines 17 

58 Unary Manipulation Routines 17 

59 TITLE 17 

60 SFLAG, RFLAG 18 

61 TLU-Table Look-up 18 

62 DSL Block Manipulation Routines 18 

63 BBN-121a Floating Point Interpreter (Modified 19 
for DECAL-BBN) 

64 BBN-23 Random, Randmodn, Coin 19 

65 UAC-14 Digital Function Generate and Display 19 

66 MRR - Short, Read Magnetic Tape Routines 20 

67 "SIN-COS": Floating-Point Sine-Cosine 20 
Routines 

68 "SQRT": Floating-Point Square Root Routine 20 

69 SATED: Scope Aided Tape Editor (ESD) 20 

70 OLD DECUS LIBRARY I 20 

ADA--1 Analyzer 
ADA-2 Frapcorrector 

ADA-3 PRIM; Punch Read-In-Mode Tape 
ADA-5 AID, Adams Associates Intercom and 
Debug Program 



DECUS No . Title Page No . 

71 OLD DECUS LIBRARY II 21 

BBN-1 FRAP 

BBN-2 Typewriter Control (TYC) 

BBN-6 Colossal Typewriter Program (CT) 

BBN-1 3 Binary to Decimal Printout and Punchout 

BBN-2 1 TRACE 

BBN-25 Rotate Test 

BBN-2 7 Master Duplicator 

BBN-32 Tem-Stor Push Down 

BBN-33 Pen Tracker Routines 

BBN-45 Grid Plotting Program, (plotgrid) 

BBN-54 Compare 

BBN-67 Debug (DB) 

72 OLD DECUS LIBRARY III 23 

BBN-3 Binary Punch and Load Package 
BBN-46 Binary Punchoff 

73 MADCAP; MAmmonth Decimal Arithmetic Program 23 
for the PDP-1 Computer 

74 Tapelibrary Program 24 

75 SEETAPE - A Magnetic Tape Dump Program 24 

76 A 28 -Bit Floating Point Package for the 24 
PDP-1 

77 DSL Sort Routines-Sort 2, Sort 3 24 

78 TAPE 52 Magnetic Tape Control Subroutines 25 

79 Extended Memory Punch and Loader Routines 25 

(EXPCH1 and EXPCHO) 

80 DEXTER, A Magnetic Tape Executive Routine 25 

81 Calcomp Plotter Software 25 

82 FORTRAN for the PDP-1 26 

82.3 FORTRAN for the PDP-1 (Version 3) Addendum No. 1 



DECUS No. Title Page No. 

83 340 Assembly Language and 340 DDT 26 

84 M.I.T. Floating Point Arithmetic Package 26 

85 LISP for the PDP-1 27 

86 Precision Hypotenuse/Square Root Addendum No. 1 
Subroutine 

87 Buffered DECtape Read and Write Routines Addendum No. 1 



PDP-4/PDP-7 INDEX 
PDP-4 

DECUS No. Title Page No , 

4-1 PDP-4 Automonitor Program 30 

4-2 Teletype Input and Output Package 30 

4-3 Random Number Subroutine 30 

4-4 Read a Decimal Number From Keyboard 30 

4-5 KUS - Kie Utility System 30 

4-6 DDT-4 With Floating Point Input/Output 31 
and Drum Read-Write 

4-7 Bivariate Curve Fit (FOX PR-3) 31 

4-8 Short-Loader for the PDP-4-Flynn Loader 31 

4-9 SQRT - Single Precision Square Root 31 
Subroutine 

4-10 Multi-Clock Simulation Subroutine 32 

4-11 Engineering Project Scheduling System 32 

4-12 Boolepac Subroutine 32 

4-13 FISP: Foxboro Interpretive Simulation Addendum No. 1 
Program 



PDP-7 



DECUS No . Title Page No . 

7-1 Accelerated Radix Deflation and 33 
Superdecimal Data Bytes on the PDP-7 

7-2 FAST Start 33 

7-3 CUS - Console Utility System 33 

7-4 PTSCOPE, PTPEN, PTPLOT, CALIBRATE, LISTEN 34 

7-5 KINEMATICS 35 

7-6 CGC Function 35 

7-7 INPUT ND 180, INFLT ND 180, INPUT 35 
VICTOREEN, and INFLT VICTOREEN 

7-8 FPTSCOPE, FPTPEN, and FPTPLOT 36 

7-9 Scope Text Editor (SI) 36 

7-10 DECPUN - Decimal Integer Punch Routine Addendum No. 1 

7-11 POSPNT - Positive Decimal Integer Addendum No. 1 
Print Routine 

7-12 Punch Output Package Addendum No. 1 

7-13 Preliminary Programming Manual for the Addendum No. 1 
340 Display 



PDP-5/PDP-8 INDEX 



DECUS No. 



Title 



5-1 & 5-2 Service and Debugging Subroutines for 
the PDP-5 

5-1.1 BPAK - A Binary Input -Output Package 
for the PDP-5 

5-2.1 OPAK - An On-Line Debugging Program 
for the PDP-5 

5-3 BRL - A Binary Relocatable Loader with 
Transfer Vector Options for the PDP-5 
Computer 

5-4 Octal Typeout of Memory Area with Format 
Option 

5-5 Expanded Adding Machine 

5-6 BDC to Binary Conversion of 3-Digit 
Numbers 

5/8-7 Decimal to Binary Conversion by Radix 
Deflation on PDP-8 

5-8 PDP-5 Floating Point Routines 

5/8-9 Analysis of Variance PDP-5/8 

5-10 Paper Tape Reader Test 

5-11 PDP-5 Debug System 

5-12 Pack-Punch Processor and Reader for the 
PDP-5 

5-13 PDP-5 Assembler 

5/8-14 Dice Game for the PDP-5, PAL 
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38 

Addendum No. 1 

Addendum No. 1 

38 

39 

39 
39 

39 

40 
40 
40 
41 
41 

41 
41 



DECUS No . Title 

5-15 ATEPO (Auto Test in Elementary 

Programming and Operation of a PDP-5 
Computer) 

5/8-16 Tape Duplicator for the PDP-5/8 

5/8-17 Type 250 Drum Transfer Routine For 
Use on PDP-5/8 

5-18 Bin Tape Disassembler for the PDP-5 

5-19 DDT-5-2 Octal -Symbolic Debugging Program 

5/8-20 Remote Operator FORTRAN System 

5/8-21 Triple Precision Arithmetic Package 
for the PDP-5 and the PDP-8 

5-22 DECtape Duplicate 

5/8-23 PDP-5/8 Oscilloscope Symbol Generator 

5-24 Vector Input/Edit 

5-25 A Pseudo Random Number Generator for 
the PDP-5 Computer 

5-26 Compressed Binary Loader (CBL) Package 

5/8-27 ERC Boot 

5/8-28 PAL III Modifications for PDP-8 and 
ASR-33 

5/8-29 BCD to Binary Conversion Subroutines 

5-30 GENPLOT - General Plotting Subroutines 

5-31 FORPLOT - FORTRAN Plotting Program 
for PDP-5 
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42 

42 
43 

43 
43 
43 
43 

44 
44 
44 
44 

45 
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Addendum No. 1 
Addendum No. 1 
Addendum No. 1 



DECUS NO , 
5/8-32 

5/8-33 
5-34 

5/8-35 



5-36 
5-37 
5/8-38 

5/8-39 



Title 

Program to Relocate and Pack Programs 
in Binary Format 

Tape to Memory Comparator 



Page No . 
Addendum No. 1 

Addendum No. 1 



Memory Halt - A PDP-5 Program to Store Addendum No. 1 
Halt in Most of Memory 



Binary Coded Decimal to Binary 
Conversion Subroutine and Binary to 
Binary Coded Decimal Subroutine (Double 
Precision) 

Octal Memory Dump Revised 

Transfer II 

FTYPE - Fractional Signed Decimal 
Type -In 

DSDPRINT, DDTYPE - Double-Precision 
Signed Decimal Input -Output Package 



Addendum No. 1 



Addendum No. 1 

Addendum No. 1 

Addendum No. 1 

Addendum No. 1 



5-40 



ICS DECtape Routines (One-Page) 



Addendum No. 1 



PDP-1 PROGRAM LIBRARY 
ADDENDUM NO. 1 



DECUS No. 82.3 

FORTRAN for the PDP-1 (Version 3) 

This version, performed with the MUL/MUS switch set to MUL and the 
DI7/DIS switch to DIV, replaces Version 2 for machines with MUL 
DIV hardware. Errors found in Versions 1 and 2 have been corrected 
and several changes made. One important addition is a check for 
mixed mode arithmetic, or "if", statements. Mixed mode combines 
fixed-point and floating point variables in one statement. 

This version includes the FORTRAN "Print" Statement for use with 
a DEC Type 64 Line Printer. For systems without line printers, 
the following alteration can be made: change the clear print buf- 
fer instruction (730445) in location 4527 of the tape labeled 
"subroutine package" to a NOP instruction (760000) . 

DECUS No. 86 

Precision Hypotenuse/Square Root Subroutine 

Precision Hypotenuse forms the 34-bit sum of the squares of two 
17-bit 1* s -complement deltas and takes the square root. Precision 
Square Root, indicated by coding within the comments, will calcu- 
late the 17-bit square root of a 34-bit number. 

The symbolic version of the subroutine is in Drum Frap but will 
assemble with ordinary Frap. The subroutine occupies 34^o regist- 
ers, using automatic multiply and divide hardware, and requires a 
constant of 200000 8 . 

DECUS No. 87 

Buffered DECtape Read and Write Routines 

These routines simulate paper tape on DECtape; instead of PPA and 
RPA the user writes JSP WRITEDT READDT. 



DECUS No. 87 (continued ) 

Buffered DECtape Read and Write Routines 

The routines take 152I3 locations plus constants including two 
40O3 wor d buffers for DECtape. The routines assume the computer 
is in extend and sequence break modes and return it to this state, 

The characters are punched onto DECtape two per word, permitting 
7763 characters on one DECtape block. The first location in the 
DECtape block contains the number of characters within the block. 
If this number is less than 776, the file ends after the last 
character in the buffer. A special return is available when the 
READDT routine reaches the end of the file. 



PDP-4/PDP-7 PROGRAM LIBRARY 
ADDENDUM NO. 1 

PDP-4 



DECUS NO. 4-13 

FISP: Poxboro Interpretive Simulation Program 

The PDP-8 simulator, designed for Foxboro's Service Center PDP-4, 
uses some Foxboro peripheral equipment. The only generally use- 
ful feature that requires Foxboro devices in the present simulator 
is tracing, which uses their Selectric typewriter module. It ap- 
pears that with some modification the simulator could use the 
teleprinter for tracing. 

Machine requirements for the simulator are: 

1. PDP-4 with EAE and 8,192-word core memory to simulate PDP-8 
with EAE Type 182, Teletype Model 33-ASR keyboard and printer, 
Reader Type 750, and Punch Type 75 with all utility functions 
except tracing. 

2. PDP-4 with EAE and 8,192-word core memory, and Type 24 
Drum to simulate a PDP-8 with the same options as above plus 
Memory Extension Control Type 183, one additional memory field, 
and Drum Type 250 with all utility functions except tracing. 

Symbolic tapes and documentation are available. 



PDP-7 



DECUS NO. 7-10 

DECPUN - Decimal Integer Punch Routine 

DECPUN is a decimal integer punch routine. This permits raw data, 
as acquired by a PDP-7 in an on-line installation, to be punched 
out. Modification of the standard decimal integer print package 
(DEC 7-15-0) does not permit the operator to punch out numbers 
greater than 2 1 ?. Since many times data is considered to be all 
positive numbers (e.g., counts), DECPUN treats all numbers as 
positive, allowing for the full 2 1 ® machine capacity. This rou- 
tine calls PDICIT to punch one digit. The user must supply the 
correct routine for the paper tape code being used. (See note 
under POSPNT.) 



DECUS No. 7-11 

POSPNT - Positive Decimal Integer Print Routine 

This is a positive decimal integer print package. It is similar 
to DECPNT, except all numbers are treated as positive. It is 
available in two versions. POSPNT 1 in which initial 0's are 
printed, and POSPNT II which suppresses initial 0's. Both ver- 
sions call TDIGIT from the Teletype Output Package (DEC 7-10-0) ? 
POSPNT II also calls TSP. 

NOTE: DECPUN and both versions of POSPNT are written so that 
less than the full six decimal digits may be punched or printed 
if so desired. (Of course, the binary number must be within 
this reduced range) . 

DECUS No. 7-12 



Punch Output Package 



This is an output package for punching IBM compatible 7-line 
paper tape code, as used with the IBM 1620, or the IBM Model 
26 tape-card converter and punch. Routines included are: PDIGIT 
to punch one BCD digit on tape (called with digit in AC, adds 
correct parity, etc.), PUNSP to punch a space (842) character, 
PUNEOL to punch an end-of-line (column 8) punch, PUNLDR to punch 



DECUS No. 7-12 (continued) 

Punch Output Package 

a leader on the tape (128 lines of all 7 columns) . A routine 
OPUN must be supplied to punch each character as generated by 
the package. 

DECUS NO. 7-13 

Preliminary Programming Manual for the 340 Display 

The Manual provides a single reference containing the information 
required to program the 340 Display. It summarizes information 
contained in seven DEC publications. Technical specifications 
which are not of general interest to the programer have been 
omitted, but can be found in the appropriate DEC publications 
listed in the Manual. It is assumed that the reader is familiar 
with the PDP-7 Computer. 



PDP-5/PDP-8 PROGRAM LIBRARY 
ADDENDUM NO. 1 



CHANGES : 



DECUS No. 5/8-9 - last paragraph, sentence 2, change to 
(Digital 8-5-S). 

DECUS No. 5-14 change to DECUS 5/8-14 and add: Uses Program 
interrupt facility. 

DECUS No. 5/8-16 - No longer available thru DECUS, part of 
PDP-8 Digital Software Package. 



ADDITIONS; 
DECUS No. 5-1.1 

BPAK -A Binary Input -Output Package for the PDP-5 

This is a revision of the binary package originally written by 
A.D. Hause of Bell Telephone Laboratories (DECUS No. 5-1) . With 
BPAK the user can read in binary tapes via the photoreader and 
punch them out via the Teletype punch. It may be used with any 
in-out device, but is presently written for the photoreader and 
Teletype punch. A simple modification, described in the write-up, 
converts BPAK so that it reads from the Teletype reader if the 
photoreader is disabled. In its present form it occupies loca- 
tions 7600-7777 and incorporates these features: 

1. Readin of BIN or RIM tapes with checksum verification, 
Teletype-character-ignore-provision (so that PAL error codes 
will be ignored) , and ejection of the end-of-tape from photo- 
reader. Entry is load address 7777; START. 

2. "Verify" made, which is identical to readin except that 
the program is not stored in memory. This is very useful in 
checking on correct punchout of tapes (via the checksum) 
without spoiling the stored program. 

3. Punchout in either RIM or BIN format. Checksum may be 
punched when desired. Use of readin mode will not affect 
punchout checksum. 



DECUS No. 5-2.1 

OPAK - An On-Line Debugging Program for the PDP-5 

OPAK (octal package) is a utility program which enables the user 
to load, examine, and modify computer programs by means of the 
Teletype. This program is a revision of the program written by 
A.D. Hause, Bell Telephone Laboratories (DECUS No. 5-2). Exten- 
sive use of the program has suggested many refinements and revis- 
ions of the original program, the most significant additions be- 
ing the work search and the break point. The standard version 
of OPAK is stored in 6200 to 7577 and also 0006. An abreviated 
version is available (7000 to 7577, 0006) which is identical to 
the other except that it has no provision for symbolic dump. 
Both programs are easily relocated. Control is via Teletype, 
with mnemonic codes, (e.g., "B" for inserting breakpoint, M P" for 
proceed, etc.). This program includes: 

1. Single or multiple register examination in symbolic 
or octal. 

2. Single or multiple register loading in octal. 

3. Breakpoint with accessible accumulator and link. 

4. Block shifting of words in memory, which also 
allows filling up blocks with a single word. 

5. Word search with mask, output in symbolic format. 

6. Symbolic dump which includes: 

a. variable format controlled by switch register 

b. type out of effective addresses on all instructions 

c. ability to recognize seven in-out device groups 

d. trim-code interpretation of word (SR option) . 

7. All dumps are interupted by striking any Teletype 
key, allowing rapid termination of any dump without 
using computer console. 



DECUS No. 5-2.1 (continued) 

OPAK - An On-Line Debugging Program for the PDP-5 

ADDITIONAL FEATURES IN OPAK 

Two new features have been added to OPAK (both OPAK regular and 
abbreviated) which should make its operation slightly easier. The 
manner of using OPAK is virtually unchanged. The new features 
are: 

1. There is no longer a need to type initial zeros. If you 
wish to examine register 0207, simply type 207E#. The sym- 
bol $ denotes space. If you wish to store 0000 into some 
register when loading data, type one zero. Numbers are still 
right -adjusted. If only a space or comma is typed, the reg- 
ister is left alone. 

Previously, if a nonoctal charcter was typed in load mode, it 
was ignored. Now nonoctal characters are illegal (except for 
space and comma) , and if typed will cause an immediate reentry 
of the "E"' mode. In the following example X represents any 
nonoctal character. 

4000L3523X4000=3523 

Also, 

4320E 4320=7021 4334E4320=4334 

2. Whenever OPAK is in keyboard listen mode, the accumulator 
will contain the following information: 

a. No breakpoint in effect, AO0. /^ 

b. Breakpoint in effect, AO=breakpoint location^ 

It is possible at a glance to determine OPAK' s breakpoint 
status . 

The insertion of the above features required extensive revision 
of memory locations 7000-7377. A new symbolic dump has been pre- 
pared. The remainder of OPAK is unchanged, except for 7576 
and 7577. 



DECUS No. 5/8-27 

SRC Boot 

The ERC Boot is a bootstrap routine somewhat simpler than the 
one presently available for the PDP-8. This routine restores 
the entire last page, consisting of: 

1. a Clear Memory Routine, 

2. RIM Loader and, 

3. Modified Binary Loader. 

The Clear Memory routine is entered at 7600 (octal) . It clears 
(to 0000) the lower 31 pages of memory, then branches to the 
Binary Loader. 

The modified Binary Loader halts after reading tape with the 
checksum in the accumulator. If the binary tape is properly 
terminated, pressing CONTINUE takes a branch to the beginning 
location of the program. PAL compiled programs may be properly 
terminated by ending the PAL symbolic tape in the following 

manner: 

P 
A 
L 
S 
Y 
M 
P B 
R 
L 
G I 
R 
A 
M 
*START (any named starting address) 

$ 

The Binary Loader stores the octal value for START in the location 
labeled ORIGIN in BIN. The instruction following HLT in BIN is 
replaced by JMP 1 ORIGIN (5616) , causing a branch to START. 



DECUS No. 5/8-27 (continued) 

ERC Boot 

Instructions for the bootstrap operation are as follows: Toggle 
in the instructions beginning at 0030. 

0030 Load Address 

7404 Deposit 

6036 Deposit 

7012 Deposit 

7010 Deposit 

3025 Deposit 

2034 Deposit 

5030 Deposit 

0030 LOAD ADDRESS 
START 

Place the tape in the ASR33 reader with pins under the first 
character. 

Turn reader to ready. 

Press CONTINUE four times. 

When reader stops, entry may be made at 7600 (to clear memory), 
or in normal fashion to RIM or BIN. 

DECUS NO. 5/8-28 

PAL III Modifications for PDP-8 and ASR-33 

This modification of the PAL III Assembler speeds up assembly on 
the ASR-33/35 and operates only with this I/O device. The sym- 
bolic tape is read only once, on pass 0, and stored in the mach- 
ine. This pass initiates as does pass 1, except that both 
switches and 1 must be down. Other passes of the assembly 
initiate normally, but do not end the symbolic tape. 

If the program is too large for the buffer, the Teletype punches 
50, 200 codes before halting. If the program size is doubtful, 
it is advisable to leave the punch on during pass and not 
continue to pass 1. 



DECUS No. 5/8-28 (continued) 

PAL III Modifications for PDP-8 and ASR-33 

The user and symbol table starts at 2736 and the buffer begins 
at 3103, allowing room for 25 user symbols only. The highest 
location of the buffer is 7440. This leaves a buffer size of 
4336 or 2270^0, which is sufficient for a large program or a 
small program with many comments , allowing one tape character 
per location. To increase symbol table size, constants at 1413 
and 1414 may be adjusted. For instance, if 50 symbols are 
desired: 

1413 BUF, 3246 

1414 BUFCNT,-4172 

A few other modifications have been made to aid in circumventing 
the slow speed of the Teletype. The length of the leader-trailer 
tape has been shortened; there is no pass III leader punched; 
and the symbol table has no leader or trailer on either pass, 
making the symbol tape incompatible with DDT (an appropriate 
leader can be punched manually) . To restore any of these char- 
acteristics, the appropriate statements in the modifications 
tape may be deleted. 

Symbolic tape may be modified as above and a new binary tape 
produced. The binary tape must then read in after loading the 
assembler for modification. This process can be done each time 
the assembler is loaded, or the modified assembler can be punch- 
ed as a complete separate tape. 



DECUS NO. 5/8-29 

BCD to Binary Conversion Subroutines 

These two subroutines improve upon the DEC supplies conversion 
routine. Comparison cannot be made to the DECUS -supplied fixed- 
time conversion, DECUS No. 5-6, because it is specified only 
for the PDP-5. One routine is designed for minimal storage, the 
other for minimal time. Both are fixed-time conversions? time 
specified is for a 1.5-vjsec machine. 

Minimal time routine: 73.6usec/32 locations 

Minimal storage routine: 85ijsec/29 locations 

DEC routine: 64-237i;sec/37 locations 

Time for number D 1# D 2 # and D 3 , is 64 + (D 1 + D 2 ) 9.6u;Sec. 

DECUS NO. 5-30 

GENPLOT - General Plotting Subroutine 

This self-contained subroutine is for the PDP-5 with a 4K mem- 
ory and a CALCOMP incremental plotter. The subroutine can move 
(with the pen in the up position) to location (x,y) , make an 
"X" at this location, draw a line from this present position to 
location (x,y) , and initialize the program location counters. 
A binary, relocatable tape is available. 

If the subroutine is to be relocatable, the titles are: MOve, 
PLot, DRaw, and INit. The readin procedure is the same as for 
other relocatable subroutines. 

If it to be used as a normal binary tape, the subroutine will 
occupy registers 3600 to 4151 inclusive. The table below shows 
the function of each section and where it is entered. 



DECUS No. 5-30 (continued) 

GENPLOT - General Plotting Subroutine 



Title of 
Section 

MOve 



Octal Entry 
Address 

3600 



PLot 



3602 



DRaw 



3604 



INit 



3606 



Operation Performed 

The plotter pen is picked 
up and moved from pres- 
ent position to location 
(x,y) . The x-component 
is given in the AC and 
the y - component is 
given after the JMS in- 
structions. 

The pen is moved as in 
the MOve section to 
location (x # y) and an 
"X" is made. 

An approximating straight 
line is drawn from the 
present position to 
location (x # y) . The 
x-component is given 
in the AC and the y- 
component is given af- 
ter the JMS instruction. 

The x and y plotter 
location counters are 
set to 0. 



DECUS NO. 5-31 

FORPLOT - FORTRAN Plotting Program for PDP-5 

FORPLOT is a general-purpose plotting program for the PDP-5 
computer in conjunction with the CALCOMP 560 Plotter. It is 
self-contained and occupies memory locations OOOO3 to 4177q. 
FORPLOT accepts decimal data inputted on paper tape in either 
fixed or floating point formats. Formats can be mixed at will. 
PDP-5 FORTRAN output tapes are acceptable directly and any com- 
ments on these are filtered out. 

FORPLOT scales input data. The operator informs the computer, 
in advance, of the data values to be assigned to the top, bot- 
tom, right, and left plot boundaries. There are no restrictions 
on these data values. It is not necessary that any of them be 
zero, nor is it necessary that the top and right boundaries 
correspond to more positive data values than the bottom and 
left boundaries, respectively. 

All plotted graphs are 10 inches in the ordinate direction. The 
operator controls the length of the abscissa which may reach a 
maximum of 39.99 inches. 

A number of plot format options are available to the user. The 
program is capable of drawing an abscissa and ordinate axis, 
each ticked at intervals of 1 inch, at the right and bottom 
boundaries of the plot, respectively. If the user chooses to 
omit these axes, a circled point is placed at the starting point 
to indicate the bottom-right plot boundary. Points are left 
unconnected unless connected through user control. Finally, 
at the option of the user, FORPLOT can locate either a small 
"x" or a small octagon (approximately 1/16 inch across) , or a 
superposition of both at each plotted point to make the point 
more plainly visible. 

A column selection feature is provided enabling the operator to 
select data columns from tapes containing several of them. In 
this bulletin "column" refers to a column in the arrangement 
of the data when it is printed on the ASR-33. If desired, the 
operator can supply only the ordinates and the program will 
space the plotted points uniformly in the abscissa direction 
according to a present constant. 



DECUS No. 5/8-32 

Program to Relocate and Pack Programs in Binary Format 

This relocation program has a facility to accept or reject 
programs from the switch register. 

For programs which exist in modular form, the user decides 
which functions are necessary to perform a certain operation. 
Each function exists as a subroutine and all that is necessary 
is to read each subroutine into the computer and write an ex- 
ecutive to join these modules together. The main difficulty 
of using fixed subroutines is immediately apparent. Fixed sub- 
routines may overlap requiring many of them to be reassembled. 
Fixed programs also leave gaps that cannot readily be used by 
other programs. 

The relocation program will allow programs on binary formatted 
paper tape to be relocated in memory. Two modes of operation 
are provided. 

1. Relocate to a starting address specified by the 
operator from the keyboard. 

2. Relocate to registers determined by the relocation 
program. The relocation program will search the 
the memory starting from register 200 for suf- 
ficient consecutive registers to hold the new 
program. Unoccupied registers are assumed to 
contain zero. 

The following is an illustration of the manner in which this 
program can be used: 

A library tape is provided to each PDP-5/8 user on 
the project. Every subroutine module is contained 
on this tape. A user, using the relocation program, 
can choose only those subroutines for the operations 
he wishes to perform. Subroutines can be accepted 
or rejected from the switch register. Using a fast 
reader, subroutines for a set of requirements can be 
assembled in just a few minutes. 



DECUS No. 5/8-32 (continued) 

Program to Relocate and Pack Programs in Binary Format 

If a permanent record of this configuration is necessary, a 
binary punch program associated with relocation program will 
produce a binary tape of only those areas of memory containing 
program. 

This program can be adapted to a faster secondary storage 
medium such as magnetic tape. Subroutines could be called 
and relocated when required, allowing maximum storage space 
for data. 

DECUS No. 5/8-33 

Tape to Memory Comparator 

Tape to Memory Comparator is a debugging program which allows 
comparison of the computer memory with a binary tape. It is 
particularly useful for detecting reader problems, or during 
stages of debugging a new program. 

A typeout occurs whenever the memory disagrees with the contents 
of the binary program tape. The typeout consists of the mem- 
ory location, contents of memory, and contents of the tape on 
one line. The checksum is typed out as an error at one location 
greater than the last address on the tape. 

Presently, the program uses a high-speed reader; however it 
may be modified for the TTY reader. The program occupies 165 
octal locations on a single page. It does not use page or 
autoindex registers. 



DECUg No. 5-34 

Memory Halt - A PDP-5 Program to Store Halt in Most of Memory 

With Memory Halt and OPAK, (DECUS No. 5-2.1), in memory, it is 
possible to store halt (7402) in the following memory locations: 

0001 to 0005 
0007 to 6177 
7402 and 7403 

Memory Halt occupies locations 0200 to 0237 with a starting 
address of 0200. When started, it stores 7402 in locations 
0001 to 0005 and locations 7402 and 7403. It then sets up 
some memory location so that OPAK can store 7402 in location 
0007 to 6177. 

Halts in memory are useful when a program transfers control to 
an area of memory not occupied by the program itself. Upon 
executing the JMP or JMS instruction, the computer halts. With 
careful investigation, the programmer can determine why the 
transfer of control took place. 

DECUS NO. 5/8-35 

Binary Coded Decimal to Binary Conversion Subroutine and 
Binary to Binary Coded Decimal Subroutine (Double Precision) 

This program consists of a pair of relatively simple and 
straightforward double-precision conversions. They make no 
claim to speed or brevity. A double entry has been used which 
is: 

TAD High 

JMS BCD Bin 

TAD Low 

JMS BCD Bin+3 



DECUS NO. 5-36 

Octal Memory Dump Revised 

The Octal Memory Dump on Teletype is a DEC routine (DEC-5-8-U) 
which dumps memory by reading the switch register twice; once 
for a lower limit and again for an upper limit. 

It then types an address, the contents of the program and the 
next three locations, issues a CR/LF, then repeats the process 
for the next four locations. This leaves the right two-thirds 
of the Teletype page unused. The 78^q instructions occupy two 
pages. 

This revised routine uses the complete width of the Teletype 
page and occupies only one memory page, using less paper and 
two less instructions. Now an address and the contents of 15 
locations are typed out before a carriage return. 

Octal Memory Dump Revised has proved its value as a subroutine 
and/or a self-contained dump program when it is necessary to 
dump large sections of DECtape, magnetic tape (IBM compatible) , 
or a binary formatted paper tape. 



DECUS NO. 5-37 

Transfer II 

For users who have more than one memroy bank attached the PDP-5/8, 
Transfer II may prove valuable in moving information from one field 
to another. Often areas designated for loaders are being used for 
other reasons, only to find the loaders necessary a few minutes 
later. When debugging, Transfer II enables a programmer to make 
a few changes in a new program and test it without reading in the 
original program again, especially if his corrections did not 
work. In short, Transfer II enables more extensive use of memory 
banks . 



DECUS No. 5/8-38 

FTYPE - Fractional Signed Decimal Type-In 

Enables a user to type fractions of the form: .582, - .73, etc., 
which will be interpreted as sign plus 11 bits (e.g., 0.5 = 2000g) 
Subroutine reads into 3000-3177 and is easily relocated, as it 
will work on any page without modifications. 



DECUS No. 5/8-39 

DSDPRINT, DDTYPE - Double-Precision Signed Decimal Input -Output 
Package 

DSDPRINT, when given a signed 24-bit integer, types a space or 
minus sign, and then a 7-digit decimal number in the range - 
8388608 to +8388607. DDTYPE inables the user to type in a signed 
decimal number in either single or double precision. These rou- 
tines are already separately available, but the present subroutine 
package occupies only one memory page and allows for more ef- 
ficient memory allocation. Located in 3000-3177, but will work 
on any page. 



DECUS No. 5-40 

ICS DECtape Routines (One-Page) 

The routines will read or write from the specified DECtape unit 
and delay the program until all I/O is completed. The last block 
read will overflow the specified region and destroy one core 
location. Only standard 129 word DECtape blocks will be read or 
written. The routines will halt if an error occurs with the 
status bits in the AC. 



